home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / System / DOpus / DopJoin4 / DopJoin.doc < prev    next >
Encoding:
Text File  |  2001-04-02  |  4.7 KB  |  129 lines
  1.  
  2.                  Join files with DirectoryOpus 4.x
  3.                  ---------------------------------
  4.  
  5.                             DopJoin
  6.                           DopJoinAsync
  7.                           ============
  8.  
  9.                      Version 1.03a - 01.04.01
  10.  
  11.                          © H. van der Ree
  12.  
  13.                          hivdree@uwnet.nl
  14.  
  15.  
  16. DopJoin and DopJoinAsync are small programs with which you can
  17. join files with DirectoryOpus 4.xx.
  18.  
  19. DopJoin and DopJoinAsync are copyright 2001 by H. van der Ree
  20. and EMailware. That means if you like them and use them, you must
  21. send me an email. I would really like to hear about how you've used
  22. the programs.
  23.  
  24. DopJoin and DopJoinAsync are free to use and copy as you see fit.
  25. The Author retains all rights to the programs. The Author is not
  26. responsible for any damage the programs may cause. If you distribute
  27. the archive, you MUST distribute the entire package.
  28.  
  29. These programs may be included in any archive collection. 
  30.  
  31. =====================================================================
  32.  
  33. DESCRIPTION:
  34.  
  35. Not much to say really: these little programs join all the selected
  36. files in the source lister to a new file in the destination lister.
  37. DopJoin and DopJoinAsync only work on files, selected dirs will be
  38. ignored but will be deselected.
  39.  
  40. DopJoin and DopJoinAsync will ask for a filename and will add the
  41. path of the destination. If a filename is given WITH a full path the
  42. path is stripped!
  43.  
  44. New for version 1.03 is the option APPEND. When used the selected
  45. files will be added to the destination file. If the file doesn't
  46. exist it will be created. Without this option an existing file
  47. in the destination with the same name will be overwriten!
  48.  
  49. Also new for this version is the option KEEP. This will keep the
  50. temporary file in T: in which the files are listed that were joined.
  51. The first line of this file is the name of the destination file.
  52.  
  53. Errors, if any, will be saved to file RAM:DopJoinErrors. They are
  54. listed with date and time, IoErr() and what caused the error.
  55.  
  56. DopJoinAsync does the same as DopJoin but uses asyncio.library.
  57. It is ~20% faster.
  58.  
  59. =====================================================================
  60.  
  61. REQUIREMENTS:
  62.  
  63. DirectoryOpus 4.11 or 4.15b or newer. Version 4.12 up to 4.15a would
  64. trash memory if the result from arexx was bigger then 256 chars.
  65.  
  66. ARexx must be running. DopJoin and DopJoinAsync use ARexx to
  67. communicate with DirectoryOpus.
  68.  
  69. If you want to use DopJoinAsync asyncio.library must be in Libs:
  70.  
  71. DopJoin and DopJoinAsync have been tested with FFS 45.9 and OS2.1 up
  72. to OS3.1.
  73.  
  74. =====================================================================
  75.  
  76. INSTALLATION:
  77.  
  78. Install DopJoin or DopJoinAsync as an AmigaDOS program with one
  79. argument: {p}. The only flag that MUST be set is 'Run asynchronously'!
  80. Optionally you can add the options KEEP and/or APPEND.
  81.  
  82. An other way is to 'run <>NIL: DopJoin {p} [KEEP] [APPEND]'.
  83.  
  84. If DopJoin or DopJoinAsync aren't running asynchronous Dopus will be
  85. locked!
  86.  
  87. =====================================================================
  88.  
  89. HISTORY:
  90.  
  91.   DopJoin:
  92.  
  93.   1.01 - 16.03.01  First public version.
  94.   1.02 - 16.03.01  Internal version.
  95.   1.03 - 21.03.01  Added two options; KEEP/S and APPEND/S.
  96.                    KEEP:   don't delete the temporary file in T: in
  97.                            which the files are listed that were
  98.                            joined. The first line of this file is
  99.                            the name of the destination file.
  100.                    APPEND: add the selected files to an already
  101.                            existing file. If this file doesn't
  102.                            exists it will be created.
  103.                    Fixed returncode, was always 20.
  104.                    Added full errorchecking to read/write actions.
  105.                    If a read causes an error, the file read will be
  106.                    skipped. If a write causes an error the whole
  107.                    process will be stopped.
  108.                    Errors are saved to file RAM:DopJoinErrors.
  109.  
  110.   DopJoinAsync:
  111.  
  112.   1.03 - 01.04.01  First public version.
  113.                    It has the same functionality as DopJoin but it
  114.                    uses asyncio.library for it's I/O.
  115.                    It is tested with versions 39.2 and 40.4. It
  116.                    doesn't use the PPC functions of 40.4.
  117.  
  118. =====================================================================
  119.  
  120. DISCLAIMER:
  121.  
  122.   THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  123.   EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
  124.   ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
  125.   RESULTING FROM THE USE OF THE PROGRAM. THE ENTIRE RISK AS TO THE
  126.   USE OF THIS PROGRAM IS ASSUMED BY THE USER.
  127.  
  128. =====================================================================
  129.